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Introduction 


One of the inherent differences between a digital signal processor (DSP) and other processors is the DSP’s 
ability to receive and service multiple sources of interrupts very quickly. These interrupt sources can be 
timers for setting up different time bases, external analog-to-digital converters for converting analog audio 
signals into digital data, or on-chip coprocessors indicating a task is complete. Typically, when an interrupt 
occurs, ordinary processing stops and an interrupt service routine (ISR) starts executing. The ISR’s 
function is to store the contents of critical registers, perform the processing required by the interrupt, restore 
the register contents, and restart the interrupted process. Interrupt sources on the TMS320 family of DSPs 
include: 

© Reset 

e External interrupt pins 

@ On-chip peripherals 

@ On-chip DMA (direct memory access) 

e = Traps (software interrupts) 
A DSP user’s guide defines exactly how that DSP reacts to an interrupt. Specifically, that definition 
includes: 

e@ = The interrupt latency — the time it takes from the occurrence of the interrupt (for example, a low 

pulse on an external interrupt pin) to the execution of the first instruction in the ISR 
e@ = The interrupt priorities 
© Conditions during the ISR, such as the ability to accept another interrupt 


The user’s guide also explains how to set up the DSP to handle interrupts. It explains what registers need 
to be initialized and what memory location needs to be initialized with the address of the ISR. This can be 
done in either the native assembly language or in a high-level language. 


Programming DSPs in a high-level language such as C provides for portability and maintainability. A 
program can be rapidly prototyped and proven in C and then optimized to a particular processor 
architecture. Often, the real-time or time-critical portions of the code are hand assembled in this 
optimization process, resulting in high-performance code that is also efficient and readable. 


Texas Instruments offers optimizing ANSI C compilers for the TMS320C2x, TMS320C3x, TMS320C4x, 
and TMS320C5x DSPs. The compilers produce efficient code for these high-performance processors. 
While these DSPs differ, setting up interrupts is similar for each of them. The main steps for setting up 
interrupts for TMS320 DSPs are: 

1. Create the interrupt service routines. 

2. Initialize the vector table and set up the vectors in the memory map. 

3. Enable the interrupts to the CPU. 

4. Enable the interrupt sources. 


This document describes methods of setting up interrupts for these processors inC. When C cannot be used, 
C-callable assembly language routines or in-line C statements are used. Topics covered in this document 
include: 

C in-line assembly language 

C-callable assembly language modules 

Assigning symbols at link time 

°C40 parallel runtime-support library (PRTS) 

Initializing peripherals in C 

Individual placement of C variables/arrays in a DSP memory map 

Installing interrupt vectors at run time 

Accessing memory-mapped CPU registers in C 


Sample code segments are given throughout this document, and Appendix C contains complete examples 
of how to set up interrupt vectors for all the processors discussed herein. 


Creating an Interrupt Service Routine 


The first step in setting up interrupts in C is to define the ISR. The ISR is no different from an ordinary C 
subroutine except for the name of the routine. 


Naming Convention 


By naming the subroutine c_intnn, where nn can be 00 to 99, the floating-point DSP C compiler can identify 
the routine as an ISR and can follow different rules for saving and restoring registers. Ordinary routines 
save and restore registers that are used by the routine according to the rules defined in the appropriate C 
compiler manual. Interrupt service routines need to save and restore every register that is used by the ISR. 
The next example shows an ISR defined in C: 


void c_int11 (void) 


{ 


receiveCounter+t+; 


} 


For readability, it is possible to use a macro definition to rename c_intnn with a more descriptive name. 
For example: 

#define serialPortReceiveISR c_intl1l 

void serialPortReceivelISR (void) 


{ 


} 


For the fixed-point DSP C compiler, the ISR name must be c_intn, where n can be 0 to 9. Also, in the 
fixed-point DSP C compiler, all of the registers are saved and restored, using the runtime-support library 
functions J$$SAVE and I$$REST. However, in version 6.50 of the fixed-point DSP C compiler, the keyword 
interrupt can be used instead of c_intn. For example: 


receiveCounter+t+; 


interrupt void serialPortReceive ISR (void) 


{ 


This directs the compiler to generate ISR code for the routine called serialPortReceive ISR. 


The TMS320CSx can use faster versions of IS$SAVE and IS$REST if version 6.50 of the compiler is used 
and no interrupts are nested. These faster versions rely on the ’C5x shadow registers for context save and 
restore. 


While there is a correlation between an interrupt vector’s location and its functionality, there is no 
correlation between the ISR name and its interrupt functionality. However, c_intOO (for floating-point 
DSPs) and c_int0 (for fixed-point DSPs) are defined in the respective runtime-support (RTS) library as the 
reset routines for initializing the C environment. These routines are found in the file boot.asm in the 
appropriate RTS source archive library. Note that C variables and function names are defined in assembly 
language using the underscore symbol (_) preceding the label. For example, the function c_int00() could 
be executed in assembly language by branching to label _c_int00. Two rules apply: (1) no parameters can 
be passed to an ISR, and (2) nothing can be returned from an ISR. 


Calling Other Functions 


In the floating-point DSP C compiler, when an ISR calls another function, the C compiler forces the ISR 
to save and restore all CPU registers, not just the ones used in the ISR. This is because the compiler has 
no guaranteed way of knowing what registers are used in the called function since the function may be 
externally defined. Therefore, to minimize the length of the ISR, avoid calling other functions from within 
the ISR. 


ISR Contents 


The work performed by the ISR depends on the type of interrupt processing that is required. Typically, 
because no parameters are passed to or from an ISR, global variables are required. In a previous example, 
the variable receiveCounter would have been declared as a global variable. If the ISR is servicing an 
interrupt from an on-chip peripheral, then the peripheral registers are read from and/or written to. In the 
next example an ISR services the on-chip serial port to which an A/D and D/A converter is connected. 
Data is transferred to and from the serial-port registers and the C variables input and output. All of the 
variables in this ISR have been declared globally. 


void c_int05 (void) 

{ 
/* Get input value read in from A/D connected to serial port */ 
input = *serPortRec; 


/* Write output value to D/A connected to serial port */ 
*serPortTrans = output; 


Setting Up Interrupt Vectors 


After creating the ISR, the vector (or address) of the ISR must be appropriately loaded into memory. In 
general, these vectors are located at address location 0x0 in program memory. However, some of the 
processors require or provide for installing the interrupt vectors in other locations. Appendix B contains 
interrupt-vector tables that list the locations in program memory at which interrupt vectors should be 
installed for each of the TMS320 DSPs. 


Table 1 shows a portion of the TMS320C3x interrupt-vector table. 
Table 1. Interrupt-Vector Locations for the TMS320C3x 


[erupt [ wenerytesaion | Funeion 


Serial Port 0 Transmit 
Serial Port 0 Receive 


a External Interrupt 3 


Vector Table Locations 


For the TMS320C25, the TMS320C26 in microprocessor mode, the TMS320C28, the TMS320C30, and 
the TMS320C31 in microprocessor mode, the vectors always start at location 0x0. For the TMS320C31 
in microcomputer/bootloader mode, the vectors start at location Ox809fc1. For the TMS320C26 in 
microcomputer/bootloader mode, the vectors start at location Oxffa0. For the TMS320C5x, reset is always 
at location 0x0, but the interrupt vectors can reside on any 2K-word page in program memory. The vector 
table location is related to the value of the IPTR bits of the PMST register. Valid interrupt-vector-table base 
addresses for the TMS320C5x are 0x0, 0x800, 0x1000, 0x1800, 0x2000, ..., Oxf800. 


For the TMS320C4x, reset can be located at one of four locations as defined by the external pins 
RESETLOCO and RESETLOC1. The TMS320C4x’s interrupt vectors can reside on any 512-word 
boundary in memory. The vector table location is defined by the value of the word stored in the [VTP 
(interrupt vector table pointer) register. Additionally, The TMS320C4x’s trap interrupt vectors can reside 
on any 512-word boundary in memory. The trap vector table location is defined by the value of the word 
stored in the TVTP (trap vector table pointer) register. Valid interrupt-, or trap-, vector-table base addresses 
for the TMS320C4x are 0x0, 0x200, 0x400, 0x600, 0x800, Oxa00, Oxc00, Oxe00, 0x1000, 0x1200, ..., 
Oxfffffe00. 


This information is summarized in Table 2. For further explanation and detail, refer to the appropriate 
device user’s guide. 


Table 2. Interrupt-Vector Table Locations for the TMS320 DSPs 


Pr ‘ Vector Table Coriirfient 
eyeere Base Address een 
TMS320C2x Ox0 Not including TMS320C26 in 
microcomputer/bootloader mode 


x 
TMS320C26 Microcomputer/bootloader mode 
TWS820030 ee 
TMS820631 
TMS320C31 0x809fc1 Microcomputer/bootloader mode 


Reset OxO, Ox7fff ffff Reset vector location defined by external pins 
0x8000 0000, Oxfff ffff RESETLOCO and RESETLOC1 
TMS320C4x Interrupt Vectors | Any 512-word boundary aT Sehaeeauer BGGrese relneaiDy 
Trap Vectors Any 512-word boundary aie caeer base address defined by value 


TMS320C5x i 
Interrupt Vectors | Any 2K-word page ea to value of IPTR bits of the PMST 


There are two methods of placing the interrupt vectors in the memory map at the appropriate location. 
These two methods are described in the following sections. 


Method I: Using a Named ASM Section 


The more straightforward method for appropriately placing interrupt vectors is to create a table in assembly 
language using the named-section assembler directive .sect. This table contains the addresses of the 
interrupt vectors or branch-to-address instructions. 


The TMS320C2x, the TMS320C5x, and the TMS320C31 in microcomputer/bootloader mode execute the 
code at the interrupt vector locations. Therefore, branch-to-address instructions must be used as interrupt 
vectors. For the TMS320C31 in microcomputer/bootloader mode, use the 24-bit branch instruction BR to 
enable branching to any location in the address space. For example, on the TMS320C3 1, interrupt vector 
1 could be defined in assembly language as follows: 


INTIC «br cc antod 


On the TMS320C30, the TMS320C31 in microprocessor mode, and the TMS320C4x, the value at the 
interrupt vector is used as the address of the next instruction to be fetched. Therefore, the address of the 
appropriate ISR must be stored at the interrupt vector location using the .word assembler directive. For 
example, on the TMS320C4x, interrupt vector | could be defined in assembly language as follows: 


INT: . -wore 2c incu 
Note the underscore symbol (_) preceding the c_intO/ function name in the previous two examples. 


Because the ISR labels are declared external to the assembly language module, the labels must be declared 
as .ref or .global. Following is an example of an assembly language module, vecs.asm, that defines anamed 
section containing TMS320C5x branch-to-address vectors: 


.ref S@inted, .C-Tnt9 ;reference interrupt vectors defined externally 


sect “vectors” ;declare a named section “vectors” 
Rob Senco ;branch to reset vector 
I1l:b =C 1nt9 ;branch to interrupt vector 1 
I2:b AG ant9 ;branch to interrupt vector 2 


Handling Reserved and Unused Locations 


Sometimes the interrupt vector table contains reserved locations, as in the case of the TMS320C26 in 
microcomputer/bootloader mode or the case of noncontinguous TMS320C4x or TMS320C5x reset and 
interrupt vectors. This also occurs on spinoff devices with different peripherals, such as the TMS320C31. 
Also, your system may not use all of the interrupts available. To handle these holes in the vector map, the 
.Space assembler directive can be used. Note that on the fixed-point devices, .space reserves bits, while on 
the floating-point devices, .space reserves words. For example, on the TMS320C26 in 
microcomputer/bootloader mode, if you were to use every interrupt available, your vector map might look 
like this: 


-sect "vectors” ;define named section 
;for reset & interrupt vectors 

.space 216 ; reserved 

b _c_intl ; INTO 

b er ome one ; INTL 

b tt eae sINT2 

b _c_int4 ; TIN 

b C2ant5 ,;RINT 

b _c_int6 7 XINT 

b Premk oven) ; TRAP 


Note that the .space directive reserves one location for the reset vector that is not employed in bootloader 
mode because reset invokes the bootloader in microcomputer/bootloader mode. Here, the section vectors 
would be linked to location Oxfa00. Alternatively, the .space directive could have been removed and the 
section linked to location Oxfa02. 


If, however, only the timer and trap interrupt vectors are to be used, the vector map could be defined as 
follows using the .space directive: 


-sect “vectors” ;define named section 

;for reset & interrupt vectors 
.space 2*4*16 ;reserved and 3 unused vectors 
b c_int4 , TINT 
.space Zee LG ;2 unused vectors 
b oC int] ; TRAP 


Note that the unused portions of the interrupt or trap vector table can be used to store data values. However, 
to ensure that interrupts are handled correctly, make sure that the used interrupt or trap vectors are not 
corrupted. 


Linking Into the Memory Map 


Once the named section is created, the name of the section (vectors in the last example) can be used as a 
handle to link the table to the appropriate location in the memory map using the TMS320 linker 
(LNK30.EXE or DSPLNK.EXE, for floating-point or fixed-point DSPs, respectively). There are three 
steps to this: 

1. Link in the assembly language module. 

2. Define a linker MEMORY section corresponding to the interrupt vector locations. 

3. Use the linker SECTIONS area to place the named section into the previously defined 

MEMORY section. 


The following is a linker command file segment for the TMS320CSx. It links a named section vectors to 
location 040h. 
-c 


vecs.obj /* (1) Link in the vector table */ 
main.obj 


-lrts50.1lib 


MEMORY 
{ 


PAGEO:VECTORS: origin = 0000h, length = 0003fh /* (2) Declare mem for vectors */ 


ROM: origin = 0040h, length = 007cfh 
} 
SECTIONS 
{ 
"vectors": {} > VECTORS /* (3) Place vector table */ 
-text: {} > ROM 
} 
Bootloader 


When using the bootloader on the TMS320 DSPs, the default entry point for code execution is the 
destination address of the first word transferred by the on-chip bootloader. The hex conversion bootloader 
utilities (HEX30.EXE and DSPHEX.EXE) have provisions for overriding this entry point and defining it 
to be the address of the reset routine. When using the device in bootloader mode, there is no reset ISR; 
instead, resetting the device causes the bootloader to execute. 


Method II: Installing a Run-Time Vector 


Another method that is useful during development and debugging is installing the vectors at run time by 
loading the address of the ISR into the proper location using a C statement. This is appropriate only for the 
TMS320C30, the TMS320C31 in microprocessor mode, and the TMS320C4x, because they use addresses 
and not branch-to-address instructions as interrupt vectors. The intention is to use a C typecast to put the 
address of the ISR into the desired memory location. For example, on the TMS320C30, location 0x1 
corresponds to external interrupt 0 (INTO). To install the ISR c_int0O1() there, use the following statement: 


x CUtwoid 44") 4) ) O81) = cline; 


Here, location 0x1 is being typecasted as a pointer to a function, because it contains the address of the 
function c_intO/(). The danger is that the C programmer might overwrite data or program memory that is 
allocated by the linker. 


Vector Table Pointers 


The TMS320CS5x and TMS320C4x devices have provisions for placing interrupt vectors in locations other 
than 0x0. Both have registers to enable the processor to identify the location of the vectors. The 
TMS320C4x can also define the reset vector to reside in one of four locations, as determined by pins on 
the processor. For interrupts to be processed correctly, their interrupt-vector-table pointers must be 
initialized prior to receiving any interrupts. The following four examples illustrate techniques for 
initializing these registers. 


Example 1. Using a C In-Line ASM Statement on the TMS320C4x 


This example uses C in-line assembly language instructions to set the TMS320C4x interrupt vectors to start 
at location 0x0 by setting the value of the IVTP register to 0x0 in a hard-coded fashion. 


asm(“\t PUSH \t 4r0”); 
asm(“\t LDI \t Oh, r0”); 
asm(“\t LDPE \t 10, \vtp”); 
asm(“\t POP \t r0”); 


The backslash t (\t) is used to insert tabs in the assembly language instruction. 


Example 2. Using the TMS320C4x PRTS 


This example uses the TMS320C4x parallel runtime-support library to set the TMS320C4x interrupt 
vectors to start at location 0x02ff800, the start of RAM block 0, by setting the value of the IVTP register 
using the set_ivtp() PRTS library function. When using the PRTS, no named section of interrupt vectors 
is required from the user. Instead, the install_int_vector() PRTS function is used to install vectors at run 
time into the predefined section . vector. In this method, vectors are installed at run time in a way that ensures 
that no program or data will be overwritten. First, the PRTS library is linked to the program, and the 
predefined section .vector is allocated to reside at the start of RAM block 0 using a linker command file 
as follows: 


~lprts40.1lib 


MEMORY 


RAMO: org = O0x2ff800 len = 0x400 /* RAM Block 0 */ 


ECTIONS 


ANY 


" vector”: {} > RAMO /* Allocate space for interrupt */ 
/* vectors for C40 PRTS */ 


} 


The main program must include the header file intpt40.h. The set_ivtp() function can now be called using 
the predefined argument DEFAULT, which sets the ivtp to the address of the section . vector as defined in 
the linker command file above. The interrupt vectors can be installed using the install_int_vector() 
function as follows: 


#include <intpt40.h> 


void c_int99 (void) 


{ 
} 


void main(void) 


{ 


for(;;); 


set_ivtp (DEFAULT) ; /* Initialize the IVTP */ 
/* vegister */ 
install_int_vector((void *) c_int99, 2); /* Install timer interrupt */ 


Example 3. Using Memory-Mapped Registers on the TMS320C5x 


The following example sets the TMS320CSx interrupt vectors to start at location 0x800 by hard coding the 
value of the IPTR bits of the PMST register to 0x800 in C using a pointer to the memory-mapped register, 
PMST, which is located at address 0x7. 


unsigned int *pmst = (unsigned int *) 0x7; /* PMST register */ 
*xpmst | = 0x800; /* Initialize IPTR bits of PMST */ 


Example 4. Assigning Symbols at Link Time on Either the TMS320C4x or the 
TMS320C5x 


While the TMS320C5x C compiler does not have a PRTS library to assist in setting up the vector-table 
pointer registers, there is a flexible, portable method for accomplishing the same task on both the 
TMS320C4x and TMS320C5x. This method employs assigning symbols at link time. 


The idea is to use an assembly language section (.secf) that contains reset and interrupt vectors and use the 
linker to map to the location of the placement of the interrupt vectors in memory. This address is made 
accessible to the C program and can be loaded into the interrupt vector table pointer on the TMS320C4x 
(IVTP register) or the PMST register on the TMS320C5x. 


Start by defining the interrupt vectors in an assembly language module. Following is an example using the 
TMS320C5x. To access the address of the interrupt vectors, a label is used to locate the base address of the 
interrupt-vector table. In this example, JVECS is used as the label. 


.def IVECS ; IVECS defined in this module 
.cef = ant0, “cc -itntl, Cuint2 ;reference all interrupt 
;vectors declared elsewher 


KKKKKK KKK KKK KK 


* Reset vector 
KaKKKKKK KK KKK KK 


-sect “reset” ;define named section for 
;reset vector 
b _c_into ;reset vector 


KKKKKKKK KKK KKK KKK KK 


* Interrupt vectors 
KKKKKKKKKKKKKKKKKKK 


.sect “vectors” ;define named section 
;for interrupt vectors 
IVECS .space 2 ;one reserved location 
bo 26 Amel ;interrupt vector 1 
bo ante ;interrupt vector 2 


In the linker, use a linker-assigned label to initialize a linker-defined variable. In this case, the label IVECS 
is assigned to a variable. Continuing the last example: 


-c 
vecs.obj 
-lrts50.1lib 
_vecTable = IVECS ;/* set vecTable to point to vector table */ 
MEMORY 
{ 
PAGE 0: VECTORS: origin = 00000h, length = 0003fh 
ROM: origin = 00040h, length = 007CFh 
P_RAM: origin = 00800h, length = 023FFh 
} 
SECTIONS 
{ 
"reset” > VECTORS 
"vectors” > P_RAM 
-Cexts > ROM 
Seine: > ROM 
-bSSs > RAMBO_D 
-stack: > INT_RAM 


} 


In the C program, declare the pointer to unsigned integer vecTable to be extern as follows: 
extern unsigned int *vecTable; 
Now it can be loaded into the PMST register as follows: 


unsigned int *pmst = (unsigned int *) 0x07; /* PMST register */ 

*pmst |= (unsigned int) vecTable; 

Using this method on the TMS320C5x or the TMS320C4x provides a flexible approach to loading the 
vector-table-pointer registers so that when the vector table is relocated in the linker command file, the C 
program does not need to be recompiled, only relinked. 


Enabling Interrupts 


Before interrupts can be processed, they must be enabled. There are two places that interrupts are enabled. 
All the processors described in this document have both an interrupt mask register (or interrupt enable 
register) and a global interrupt enable bit in the status register. The interrupt mask register provides 
individual control of each interrupt source to the CPU. The global interrupt mask (or enable) bit provides 
a master switch to turn all interrupts on and off. This bit is usually enabled once by the programmer at the 
beginning of the program. During interrupt processing, this bit is toggled off by the interrupt processing 
logic and toggled on by the return-from-interrupt instruction that ends the ISR. This is done to prevent an 
ISR from being preempted. The user can override this by re-enabling global interrupts in the ISR. 


Each processor also has an interrupt flag register. The individual bits of this register are automatically set 
when an interrupt occurs. They are automatically cleared when an interrupt is taken. It is customary to clear 
this register before enabling interrupts for the first time; however, in the TMS320C2x family, this register 
is not accessible through software. For the TMS320C3x and TMS320C4x processors, the register should 
be loaded with 0x0 to clear all interrupts. On the TMS320C5x, write a | to each bit to clear the interrupts. 
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Interrupt Flag Registers 


Table 3 identifies the interrupt flag register for each of the processors: 


Table 3. Interrupt Flag Registers for the TMS320 DSPs 


TMS320C2x Interrupt Flag Register. Not accessible through software. 


TMS320C3x Interrupt Flag Register. Not memory mapped. 
TMS320C4x IIOF_ Flag Register. Not memory mapped. 
TMS320C5x Interrupt Flag Register. Memory mapped at location 0x6. 


Interrupt Mask Registers 


The following table identifies the interrupt mask (or enable) register for each of the processors: 


Table 4. Interrupt Mask (Enable) Registers for the TMS320 DSPs 


TMS320C2x Interrupt Mask Register. Memory mapped at location 0x4. 
TMS320C3x Interrupt Enable Register. Not memory mapped. 


CPU Internal Interrupt Enable Register and DMA 
TMS320C4x IIE and DIE Coprocessor Interrupt Enable Register. Not memory 
mapped. 
TMS320C5x Interrupt Mask Register. Memory mapped at location 0x4. 


Global Interrupt Mask Bit 


The following table identifies the global interrupt mask (or enable) bit for each of the processors: 


Table 5. Global Interrupt Mask (Enable) Bit for the TMS320 DSPs 


Global 
Processor Interrupt Comments 
Mask Bit 


TMS320C2x INTM Interrupt mask bit in the status register. Accessed via EINT and DINT instructions. 
Global interrupt enable bit in the status register. Accessed via write to status register. 


TMS320C3x 
TMS320C4x Global interrupt enable bit in the status register. Accessed via write to status register. 


TMS320C5x INTM Interrupt mask bit in the status register 0. Accessed via CLRC and SETC instructions. 


Initialization 


There are several methods of initializing the interrupt mask register, interrupt flag register, and global 
interrupt bit. These methods include using asm() statements, C-callable assembly language routines, and 
C pointers to memory-mapped registers. 


Using Assembly Language to Access Interrupt Registers for Initialization 

On the TMS320C30, the TMS320C31, and the TMS320C40, the interrupt registers and the global interrupt 
enable bit in the status register are not memory mapped, so they are not accessible directly from C. There 
are two methods of indirectly accessing the registers from C. The first is to use an asm() statement in C. 
The other is to create a C-callable assembly language routine that loads the registers using arguments 
passed from the C calling program. 
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The asm() statement embeds the assembly language statement directly into the C program in a hard-coded 
fashion. The next example illustrates the use of the asm() statement to set these registers on the 
TMS320C3x: 


void main(void) 

{ 
asm(”\t LDI \t Oh, IF”); /* Clear IF register */ 
asm(”\t OR \t 3h,IE”); /* Enable external interrupts 0 and 1 */ 
asm(”\t OR \t 2000h,ST”); /* Enable interrupts globally */ 


} 

On the TMS320C2x and TMS320C5x processors, the interrupt mask bit, INTM, of the status register 
controls all interrupts globally. This bit is cleared to enable interrupts using the EINT assembly language 
instruction on the TMS320C2x and the CLRC assembly language instruction on the TMS320C5x. The 
following code illustrates the use of the asm() statement to clear the INTM bit on the TMS320C5x: 


void main(void) 


{ 


asm(”\t CLRC \t INTM”);/* Enable interrupts globally */ 


} 

The second and preferred method, using C-callable assembly language routines, leads to more reusable 
code. For example, on the TMS320C40, the value for the interrupt enable register IIE could be passed to 
a C-callable routine, initITE(), defined as follows: 


~initilIE: 
PUSH FP ;mManage stack on entry 
LDI SP, FP 
LDI *-FP(2),I1IE ;load int enable register 
LDI *-FP(1),R1 ;manage stack on exit 
BD R1 
LDI *PP,EFP 
NOP 
SUBI 2,SP 
KKK B R1 j;boranch occurs 


The function prototype for the C-callable assembly language routine is: 


extern void initIIE(unsigned int); 


and an example of calling the routine is shown below: 


initIIE(0x1);/* Enable Timer 0 interrupt */ 
Using C Pointers to Memory-Mapped Registers for Initialization 


On the TMS320C2x and TMS320C5x processors, the interrupt mask and flag registers are memory 
mapped. Hence, a C pointer can be used to access these registers directly from C. However, the INTM bit 
must be accessed as described in the previous section. The next example initializes the TMS320C5x 
interrupt registers in C using C pointers: 


void main (void) 


{ 


unsigned int *imr = (unsigned int *) 0x4; /*Declare pointer to IMR register /* 

volatile unsigned int *ifr = 

(volatile unsigned int *) 0x6; /*Declare pointer to IFR register */ 
*imr |= 0x3; /*Enable external interrupts 1 and 2 */ 
*ifr = Ox01ff; /* (Optionally) clear all interrupts */ 


12 


Note the use of the qualifier volatile in the declaration of the pointer ifr. This is used to point to elements 
(in this case, the ifr register) that can change independently of code execution. 


Enabling Interrupt Sources 


After the interrupt vectors have been installed and the interrupts have been enabled, the interrupt sources 
can be enabled. For on-chip resources such as timers, serial ports, and DMA, this amounts to starting the 
on-chip resource as described in the device user’s guide. These on-chip resources are configured and started 
using memory-mapped registers. The following example illustrates a routine for starting the TMS320C31 
on-chip DMA to transfer data and cause an interrupt. It uses the TMS320C30 peripheral control library. 


#include “dma30.h” 


extern int sourceArray[]; 
extern int destArray[]; 


void setupDMA (void) 
{ 


volatile DMA_REG * dma = DMA_ADDR: 


dma->gcontrol = 0x0; /* Stop the DMA and init to 0 */ 
dma->source = (unsigned) sourceArray; /* Load DMA source address */ 
dma->=destination = *unsigned) destArray; /* Load DMA destination address */ 
dma->transfer_counter = 5; /* Load DMA transfer count */ 


/* Start DMAto transfer data, stop and cause a CPU interrupt */ 
dma->gcontrol = START3 | INCSRC | INCDST | TCINT | TC; 


Summary 


This document describes various techniques to set up and initialize interrupts on the TMS320 DSPs using 
C wherever possible. C can be used to create the interrupt service routine and initialize any 
memory-mapped registers related to interrupts. It can also be used to install the vectors at run time. 
However, using a named assembly language section is the preferred method. Where memory-mapped 
registers are not provided, it is recommended that a C-callable assembly language routine that accepts 
register values as inputs be used to initialize those registers. Finally, the TMS320C4x C compiler provides 
a parallel runtime-support library to handle interrupts entirely in C. 
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Appendix A. Related Documents 


The following documents provide additional information on this and other DSP- or C-related topics: 


TMS320C2x User’s Guide, SPRU014. 

TMS320C3x User’s Guide, SPRU031. 

TMS320C4x User’s Guide, SPRU063. 

TMS320C5x User’s Guide, SPRU056. 

TMS320C2x/C2xx/C5x Optimizing C Compiler User’s Guide, SPRU024. 
TMS320C1x/C2x/C2xx/C5x Assembly Language Tools User’s Guide, SPRUO18. 

TMS320 Floating-Point DSP Optimizing C Compiler User’s Guide, SPRU034. 

TMS320 Floating-Point DSP Assembly Language Tools User’s Guide, SPRU035. 

Digital Signal Processor Applications With the TMS320C30 Evaluation Module, SPRAO21. 


. TMS320C4x Parallel Runtime-Support Library Reference Guide, SPRU084. 
. TMS320C3x Peripheral Control Library User’s Guide, SPRUO86. 
. The C Programming Language, Brian W. Kernighan and Dennis M. Ritchie, Prentice-Hall, 


1988. 


. TMS320 Digital Signal Processor Designer's Notebook Number 2: Avoiding False Interrupts 


on the ’C3x. 


. TMS320 Digital Signal Processor Designer's Notebook Number 21: TMS320CSx Interrupts. 
. TMS320 Digital Signal Processor Designer’s Notebook Number 24: TMS320CSx Interrupt 


Response Time. 


. TMS320 Digital Signal Processor Designer’s Notebook Number 30: Addressing Peripherals as 


Data Structures. 


. TMS320 Digital Signal Processor Designer's Notebook Number 31: Interrupts in C on the 


TMS320C3x. 


. TMS320 Digital Signal Processor Designer’s Notebook Number 35: TMS320C5x Interrupts 


and the Pipeline. 


. TMS320 Digital Signal Processor Designer’s Notebook Number 36: Improved Context 


Save/Restore Performance and Interrupts Latency for ISRs Written in C. 


Appendix B. Interrupt-Vector Maps 


This appendix describes the interrupt-vector maps for the individual TMS320 DSPs discussed in this 
document. 


TMS320C2x Interrupt-Vector Map 


The following interrupt-vector map applies to all TMS320C2x devices except the TMS320C26 in 
microcomputer/bootloader mode. 


"Nome" |_tocoton | Funton 
Name Location 


[— | e-oni7 [Reserves 


TMS320C26 (Microcomputer/Bootloader Mode) Interrupt-Vector Map 


The following interrupt for interrupt-vector map applies to the TMS320C26 in microcomputer/bootloader 


mode. 
Interrupt Memory 
Name Location 
[-— | onttao[Resenes—SSCSCSC~C*d 


INTO_ External Interrupt 0 
INT1_ External Interrupt 1 
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TMS320C3x Interrupt-Vector Map 


The following interrupt-vector map applies to all TMS320C3x devices except for the TMS320C31 in 
microcomputer/bootloader mode. 


"Nome" |_tocoton | Funton 
Name Location 


[—— | oee= oni [Resoned 


TRAP 27 | — 0x3b_——s| TRAP. 27 
|—— | 0x3 - 0x3t 


T Reserved on the TMS320C31 
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TMS320C31 (Microcomputer/Bootloader Mode) Interrupt-Vector Map 


The following interrupt-vector map applies to the TMS320C31 in microcomputer/bootloader mode. 


Interr , 
i ‘ meme asi | Function | 
Name 


[——[ora0erer-ore00ie8 [Reseed 
[——[oratee— 000i [Reserved 


TRAP 27 Ox809ffb TRAP 27 
|——_ | oxeoaffe - oxeoatt 


TMS320C4x Interrupt-Vector Map 
The following interrupt-vector map applies to the TMS320C4x. 


[inierptName | Memory Location [__Funelion +d 
iro ieee 
——___ivisortentP ste [Reseed 
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TMS320C4x Interrupt-Vector Map (Continued) 


—— ivr ronacto vt rat [Resoved 


TMS320C4x Trap-Vector Map 
The following trap-vector map applies to the TMS320C4x. 


Interrupt Memory 

Name Location 
TRAP 0 TVTP + 0x0 | TRAP O 
TRAP 1 TVTP + 0x1 | TRAP 1 


TRAP 510 | TVTP + Oxife | TRAP 510 
TRAP 511 TVTP + Oxtff. | TRAP 511 
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TMS320C5x Interrupt-Vector Map 
The following trap-vector map applies to the TMS320C5x devices. 


Interr 
i ‘i aie! noses | Funotion | 
Name 


(a 
[Pras ovra to PTR TOT [Reseved 
—— [Pras oso PTA OT [Resoved 


T Reserved on the TMS320C52 
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Appendix C. Code Examples 


This appendix provides complete examples for setting up interrupt vectors in C for the processors discussed 
in this document. 


TMS320C25 Example 


The following TMS320C25 example uses C entirely except to globally enable registers and build the vector 
table in memory. An asm() statement is used to enable the interrupts globally, and an assembly language 
named section is used to create the vector table. 


File: test.c 


[BRK RR KK KK RR RR RRR RR AR RR I I I I I / 


/* TEST.C - Test program */ 
[BRK KK KR RR RR RR ARR A RAR RAR RR RAR I I / 


[KR KK KK KR RR RR RRR RRR AR A RRR ARR I OR I I I / 


/* MAIN - Main routine wif 
[RRR RK KK KK KR RR RR RRR RR AR A RR RR RR OR OR I OR I / 


void main(void) 


{ 


initInts(); /* Initialize interrupts */ 


for(;;); /* Replace with real code */ 


File: initvecs.c 


[BRK KK KR RR RR RR RR RAR RA RR ARR I OR I I I / 


/* INITVECS.C - Interrupt vector routines *:/: 
[KOR KK KK KR RR RR RR RR RR RR A RR RRR I IR I  / 


#define globalEnableInt() asm(”\t EINT”); 


[BRK KK KK RR RR RR RR RRR RR A RRR RR RR OR OR OR I I / 


/* initInts() - Initialize processor interrupt registers tof 
[BRK KR KK KR RR RR A RA RA RR RRR AR A I I I I I / 
void initInts (void) 
{ 
unsigned int *imr = (unsigned int *) 0x04; /* IMR register */ 
*imr = 0x1; /* Enable INTO */ 
globalEnabletInt (); 


} 


[BORK RK KK KK RR RR RR RR RR RR RR A RR RR I OR RI / 


/* C_INT9 - Interrupt service routine */ 
[BRK RK KK KK RR RR RR RR RR RR A A RR RR RR OR OR I / 
#define dummyISR c_int9 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 


} 


for(;;); /* Replace with real ISR */ 
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File: vecs.asm 


KKK KKK KKK KKK KK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* VECS.ASM - Reset and interrupt vector branch table for the C25 * 


KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


-title "vecs.asm” ;file name 
.ref _c_int0,_c_int9 ;reference all interrupt 
;vectors declared elsewher 


KKK KKK KKK KKK KKK KKK KK KKK KKK KKK 


* Reset and interrupt vectors 
KERR KKK KKK KKK KKK KK KKK KK KK KKEK 


-sect "vectors” ;define named section 

;for reset & interrupt vectors 
b _c_intoO ;branch to reset vector 
b CO. Int9 ;branch to interrupt vector 1 
b _—c_int9 ;branch to interrupt vector 2 


File: test.cmd 


[RK HK IK IK I I I I I I I I I I I 


/* TEST.CMD - C25 linker command file * / 


[RK HK IK KK I I I I I I I I I I I I I / 


=€ 
vecs.obj 
initvecs.obj 
test.obj 
-mtest.map 
-otest.out 
-stack 0x400 


-heap 0x400 
SlLrts25.ltb 
MEMORY 
{ 
PAGE 0: VECTORS: origin = 00000h, length 0002Ah 
ROM: origin = 00030h, length = OO7CFh 
P_RAM: origin = 00800h, length = 02400h 
EXT_PRGM: origin = 02c00h, length = 05400h 
PAGE 1: REGS: origin = 00000h, length = 00050h 
1.0% origin = 00050h, length = 00010h 
RAMB2 origin = 00060h, length = 00020h 
RAMB 1 origin = 00300h, length = 00200h 
INT_RAM: origin = 00800h, length = 02400h 
EXT_DATA: origin = 08000h, length 08000h 
} 
SECTIONS 
{ 
“vectors”: { } > VECTORS 
-text: { } > P_RAM 
-Cinit: { } > P_RAM 
sbsse { } > INT_RAM 
.-stack: { } > INT_RAM 
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TMS320C26 Example 


The following TMS320C26 example is similar to the TMS320C25 example. For this example, a section 
named bootvecs is used to emulate the vector remapping that occurs due to the TMS320C26 boot loader. 


File: test.c 


[KR KK KK KK RR RR RR RRR RRR RRR RRR RA I RR / 


/* TEST.C - Test program af 
[BRK KKK RR RR RR RR A RR RR RR RR RR A I I OR I I / 


[KR KK KK KK RR RR RRR RR RR RA RRR RR I I I I / 


/* MAIN - Main routine aes 
[RRR KK KK RR RR RR RRR RAR RR RR RR OR OR RK I / 


void main(void) 
{ 


initInts(); /* Initialize interrupts */ 


Lor (e344 /* Replace with real code */ 


File: initvecs.c 


[KK IK IK I I I I I I I I HO / 


/* INITVECS.C - Interrupt vector routines wh 
[RK IK IK IK I I I I I HO He / 


#define globalEnableInt() asm(”\t EINT”); 


[RK HK IK I I I I I I I I I I I I I I I I I I I I I Oe / 


/* initInts() - Initialize processor interrupt registers */ 
[RK IK IK I I I I I I I I I I I I I HO He / 
void initInts (void) 
{ 
unsigned int *imr = (unsigned int *) 0x04; /* IMR register */ 
*imr = 0x1; /* Enable INTO */ 
globalEnabletInt (); 


} 


[KK IK IK I I I I I HH / 


/* C_INT1 - Interrupt service routine * / 
[RK IK IK IK I I I I I I I I He / 
#define dummyISR c_intl /* Rename ISR to correspond to TI */ 

/* naming conventions Ly 
void dummyISR (void) 
{ 


} 


LOL CF) /* Replace with real ISR */ 
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File: vecs.asm 


KKK KK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KK 


* VECS.ASM —- Reset and interrupt vector branch table for the C26 * 


KKK KK KKK KKK KK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


KaKKKK 
-title "vecs.asm” ;file name 
.cef _@ intl ;reference all interrupt 


;vectors declared elsewher 
KKEKKKKKKKKKEKKKKKKKKK KKK KKK KKK 


* Reset and interrupt vectors 
KEKE KKK KKK KKK KKK KKKKKKKK KK KKK 


-sect “vectors” ;define named section 

;for reset & interrupt vectors 
.space ZEAL 6 ; reserved 
b 6. mtd ;branch to interrupt vector 1 
b Seine) ;branch to interrupt vector 


File: boot.asm 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK 


* Boot.asm file to emulate boot loader vector remmapping bs 
KKEKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKEK 


-sect "bootvecs” 


PROG: .set OFAOOh ;Prog-Address of BO 
START B START, *,AR7 ;Reset 

B  PROG+2,*,ARO ;Interrupt 0 

B  PROG+4,*,ARO ;Interrupt 1 

B  PROG+6, *,ARO ;Interrupt 2 

-space 16 * 16 ;Reserve 16 Words 

B  PROG+8,*,ARO ;Timer-Interrupt 

B PROG+10, *, ARO ;Serial-Port-Int. 

B  PROG+12,*,ARO ;Serial-Port-Int. 

B  PROG+14,%*,ARO , Software-Interrupt 
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File: test.cmd 


[RK KK IK IK I I I I I I I I I I I I I HO / 


/* TEST.CMD - C26 linker command file * / 


[RK KK IK IK I I I 


=¢ 
vecs.obj 
boot .obj 
initvecs.obj 
test.obj 
-mtest.map 
-otest.out 
-stack 0x400 


-heap 0x400 
-lrts25.lib 
MEMORY 
{ 
PAGE Q : ROM: origin = 00000h, length = OO7FFh 
P_RAM: origin = 00800h, length = 02400h 
VECTORS: origin = OFAOOh, length = 00018h 
EXT_PRGM: origin = 02c00h, length = 05400h 
PAGE 1 REGS: origin = 00000h, length = 00050h 
TO: origin = 00050h, length = 00010h 
RAMB2: origin = 00060h, length = 00020h 
RAMB1: origin = 00300h, length = 00200h 
INT_RAM: origin = 00800h, length = 02400h 
EXT_DATA: origin = 08000h, length = 08000h 
} 
SECTIONS 
{ 
"pootvecs”: { } > ROM 
“vectors”: { } > VECTORS 
-text: { } > P_RAM 
cinit: { } > P_RAM 
.bSss { } > INT_RAM 
.-stack: { } > INT_RAM 
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TMS320C30 Example 


The following TMS320C3x example uses in-line asm() statements to initialize the interrupt registers. An 
assembly language named section is used to create the vector table. Also, the TMS320C3x DMA is 
initialized to transfer data between two C arrays and cause an interrupt when complete. The arrays are 
defined so that they can be individually located in the memory map in a different location from the .bss 
section so that the DMA and CPU will operate concurrently, that is, without a resource conflict. This 
example also illustrates how to install interrupts at run time by installing one additional vector at run time. 


File: test.c 


[BRK KK KR RR A AR A RR RR RRA A ARR RI OR I I I / 


/* TEST.C - Test program «7 
[BRK KK KK KR RR RR RR RR RR RR RR RR RR RR I / 


#include "vecs.h” 


[RRR RK KK KR RR RR RR RR RR RR RR RR RR OR I IK I / 


/* MAIN - Main routine */ 
[BRK KK KR KR RR RR RR RRR RR RRR RR RRR RR I I I I / 


void main (void) 


{ 


initInts(); /* Enable interrupts */ 
dmaInit(); /* Setup DMA for transfer and int */ 
FOL (3-3) <> /* Replace with real code */ 
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File: initvecs.c 


[RK IK IK KK I I I I A A A A A I I I I I I I I I A / 


/*INITVECS.C - Interrupt vector routines */- 
[KK KK IK I I I A A I I A I I I A I I I I I I / 
void c_int98 (void); /* function prototype */ 


[RK IK IK I I I I A A A I I I I I I I I I I I A I / 


/* initInts() - Initialize processor interrupt registers aia 
[KKK IK I I I I I A I I I A I I I I I I I A I AK A / 
void initInts (void) 


{ 


*((void (**) ()) Ox0b) = c_int98; /* Install DMA interrupt vector */ 
/* at run-time */ 

asm(”\t LDI \t Oh, IF”); /* Clear IF register */ 

asm(”\t OR \t 403h,I1IE"”); /* Enable INTO & INT1 & DMA Ints */ 

asm("\t OR \t 2000h,ST"”); /* Enable GIE bit */ 


u" 


aA 


} 


[RK IK IK I I I I A A I I I I I I I I I I I I I / 


/* C_INT99 - Interrupt service routine */ 
[KK HK IK I I I I A A A A I I I I I I I I A I I / 
#define dummyISR c_int99 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 


} 


[RK IK KK I A I I I A I I I I I I I A I I / 


/* C_INT98 - Interrupt service routine */ 
[KK IK IK I I I A I A A A I A I A I I I I I A / 
#define dummyDMAISR c_int98 /* Rename ISR to correspond to TI */ 

/* naming conventions */ 


for (;;); /* Replace with real ISR */ 


void dummyDMAISR (void) 


{ 
for(;;); /* Replace with real ISR */ 


File: dma.c 


[KK IK IK IK IK I I I I I I I I I I I I I I I I / 


/* DMA.C — Routine to setup the C3x DMA for a data transfer and interrupt */ 
/* the CPU when done af 


[KK HK IK IK I I I I I I I I HO / 


#include "“vecs.h” 


[KK IK I I I I I I HO He / 


/* dmaInit() - DMA initialization routine * / 
[RK IK IK I I I I I I I I I I I I I I I I HO Oe / 


void dmalInit (void) 


{ 
/* Pointer to DMA */ 
volatile unsigned int *dma = (volatile unsigned int *) 0x808000; 


/* Setup DMA to transfer data and set interrupt */ 


dma[4] = (unsigned int) sourceArray; 
dma[6] = (unsigned int) destArray; 
dma[8] = 5; 

dma[0] = 0xc53; 
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File: datasrc.c 


[RK KK IK IK I I I I I I I I I I I I I I / 


/* DATASRC.C - Source array Hof 
[RK KK IK IK I I I I I I I I / 


int sourceArray[] = {1,2,3,4,5}; 


File: datadst.c 


[RK IK IK IK I I I I I I I I I HK / 


/* DATADST.C - Destination array Ke. 
[RK IK IK IK I I I I I I I I I I HO / 


int destArray[5]; 


File: vecs.h 


[BRK KK KK KR RR RR RRR RR RRR RR RR RRR I I I I / 


/* VECS.H —- Header file for interrupt vector program xf 
[BRK KR KK KR RR RRR A A RRR RR A RR RRR RR OR IK I / 
extern void initInts(); 

extern int sourceArray[]; 

extern int destArray[]; 


File: vecs.asm 


KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KEK KKK KK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK 


* VECS.ASM —- Reset and interrupt vector table for the ’C30 and the ’C31 * 


7 (Microprocessor Mode) * 
KEK KKK KKK KKK KKK KKK KKK KEK KKK KK KKK KKK KEK KKK KEK KKK KKK KKK KKK KKK KKK KK KKKKKKKKKKK KKK KK 


* 


tattle "vecs.asm” ;file name 
.cef _c_int00, _c_int99 ;reference all interrupt 
KKEKKKKKKKKKKKKKKKKKKKKK KK KKK K 


* Reset and interrupt vectors 
KEKE KKK KK KKKKKKKKKKKK KKK KK KKK 


-sect “vectors” ,define named section 
.word _c_int00 ;reset vector 

-word ae nto ;interrupt vector 1 
.-word _c_int99 ;interrupt vector 2 
.end ;end of file 
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File: test.cmd 


[RK IK IK KI I I I I I I I I I I I I I I I I I I I HO / 


/* TEST.CMD - C30 linker command file * / 


[KK HK IK IK I I I I I HO HO / 


=6 
vecs.obj 
dma.obj 
initvecs.obj 
test.obj 
datasrc.obj 
datadst.obj 
-mtest.map 
-otest.out 
-stack 0x400 
-heap 0x400 
-lrts30.lib 


/* SPECIFY THE SYSTEM MEMORY MAP */ 


MEMORY 
{ 


VECS: org = 0x0 len = 0x40 

EXTO: org = 0x100 len = 0x3f00 /* EXTERNAL MEMORY */ 
RAMO: org = 0x809800 len = 0x400 /* RAM BLOCK 0 */ 
RAM1: org = 0x809c00 len = 0x400 /* RAM BLOCK 1 */ 


} 
/* SPECIFY THE SECTIONS ALLOCATION INTO MEMORY */ 


SECTIONS 

{ 
"vectors” > VECS 
-bss: > EXTO 
-text: > EXTO 
“Gantt? > EXTO 
-Stack: > EXTO 
source: {datasrc.obj(.bss) } > RAMO 
dest: {datadst.obj(.bss) } > RAMI 
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TMS320C31 Example 


The following TMS320C31 example uses an assembly language named section to build the 
interrupt-vector table and a C-callable assembly language module to set up the interrupt registers. 
However, no parameters are passed to this routine. 


File: test.c 


[KR KK KK KR RR RR RR RR RRR RR RRR RR RR I I I I / 


/* TEST.C - Test program * / 
[BRK KK KK RR RR A A RR RA RR RR RR I I / 


#include "vecs.h” 


[BRK KK KK RR RR RR RR RR RAR RA RR A I OR KI / 


/* MAIN - Main routine af 
[BRK KK KK RR RR RR RRR RR RRR RRR A I I / 


void main(void) 


{ 


initInts(); /* Enable interrupts */ 


forces) 3 /* Replace with real code */ 


File: initvecs.c 


[BRK KK KR RR RR A RR RR RRR RR RRR RRR I  / 


/* INITVECS.C - Interrupt vector routines Ai 
[KR KK KK KK RK RR RR RR RR RRR A A RR RR RR OR I / 


[BRK KK KK RR KR RR RRR RR RRR A RR A ARR RRR I I I I / 


/* C_INT99 —- Interrupt service routine * / 
[BRK KK KK RR A RRR RR RR RR AR AR A I OR OR I I / 
#define dummyISR c_int99 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 


} 


for(;;); /* Replace with real ISR */ 


File: vecs.h 


[BRK RK KK RK RR RR RR RRR RR RR A RR RR OR RR IK I / 


/* VECS.H - Header file for interrupt vector program mh 
[BRK KK KR RR RR RR RRR RR A RR AR RRR OR OR I / 


extern void initInts(); 
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File: initi.asm 
KKEKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKKKKKKKKKKKAKK KKK KKK 


* INIT.ASM - C-callable ASM routine to initialize interrupts 
KKK KKKKKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKKKKKKKKAKK KKK KKK 


*function prototype: void initInts (void) 


-file “”init.asm” 
-globl initInts 
FP .set AR3 


_initInts: 


PUSH FP ;manage stack on entry 

LDI SP,FP 

LDI 0h, IF ;clear IF register 

OR 3h,I1E ;enable INTO & INTL 

OR 2000h,ST ;set GIE bit to one to globally enable 
;interrupts 

LDI *-FP(1),R1 ;mManage stack on exit 

BD RI 

LDI *FP,FP 

NOP 

SUBI 2,SP 

B RI ;branch occurs here 


File: vecs.asm 


KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* VECS.ASM Interrupt vector branch table for the ’C31 (Bootloader Mode) * 
KEKE KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKK KK 
-title "vecs.asm” ;file name 
.cef _c_int99 ;reference all interrupt 
;vectors declared elsewher 


KKK KKKK KKK KKK KKK KKK 


* Interrupt vectors 
KKEKKKKKKKKKKKKKKKKK 


-sect “vectors” ;define named section 
;interrupt branches 

br _c_int99 ;branch to interrupt vector 1 

br _c_int99 ;branch to interrupt vector 2 


;note use of long-immediate 
;addressing mode branch (br) 


.end ;end of file 
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File: test.cmd 


[KK KK IK I I I I I I I I I I I I I I I I I I I I / 
/* TEST.CMD -— C31 linker command file * / 
[KK IK IK IK I I I I I I I I HO HO / 
=6 

vecs.obj 

init.obj 

initvecs.obj 

test.obj 

-mtest.map 

=otest.out 

-stack 0x400 

-heap 0x400 

-lrts30.lib 


/* SPECIFY THE SYSTEM MEMORY MAP */ 


MEMORY 
{ 
SRAM: org = 0x0 len = 0x100 
EXTO: org = 0x100 len = 0x3f£00 /* EXTERNAL MEMORY */ 
RAMO: org = 0x809800 len = 0x400 /* RAM BLOCK 0 */ 
RAM1: org = 0x809c00 len = 0x3C1 /* RAM BLOCK 1 - 63 words */ 
VECS: org = 0x809FC1 len = 0x3f 


/* SPECIFY THE SECTIONS ALLOCATION INTO MEMORY */ 
SECTIONS 
{ 

"vectors” > VECS 

-text: > EXTO, block 0x10000 

-bss: > EXTO 

~Cinit: > EXTO 

Const: > EXTO 

-Stack: > EXTO 

-sysmem: > EXTO 
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TMS320C40 Example With the PRTS 


The following TMS320C4x example uses the parallel runtime-support (PRTS) library to set up the 
interrupt vectors and initialize the interrupt registers. When using the PRTS library, the vector map is 
created at run time using the install_int_vector() function. The user selects the location of the vector map 
by placing the predefined named section .vector through the linker command file. The [VTP register is 
initialized using the set_ivtp() function with the argument DEFAULT. 


File: test.c 
[BRK KK KR RR RR RRR RAR A RA RAR RR A I I I I / 


/* TEST.C - Test program wef 
[RRR KK KK KK RR RR RR RR RRR RR RRA OR OR OR IK / 


#include "“vecs.h” 


[BRK KK KK KR RR RR RR RR RR RR RRR OR OR IK I / 


/* MAIN - Main routine ay 
[BRK RK KK RR RR RR RRR RRR RR A I OR I I / 


void main(void) 
{ 


initInts(); /* Initialize interrupt environment */ 


for(;;); 


File: initvecs.c 
[KR KK KK RR RRR A A RR AR AR RA AA ARR RR A I OR I I / 


/* INITVECS.C - Interrupt vector routines ay. 
[BRK KK KK KK RR RR RR RR RR RR RR RRR I RR I / 


#include "vecs.h” 
[RRR RK KK KK KR RR RR RR RR RR A RR RR I I / 


/* initInts() - Initialize processor interrupt registers */ 
[BRK KK KK RR RR A RRR RRR A RAR RR A A I  / 


void initInts (void) 

{ 
set_ivtp (DEFAULT) ; /* Set IVIP */ 
asm(”\t LDI \t Oh,IIF”); /* Clear the IIF reg */ 
set_iie(TIMERO) ; /* Enable TimerO int */ 
install_int_vector((void *) c_int99, 2); /* Install timer interrupt */ 
asm(”\t OR \t 2000h,ST”); /* Enable GIE bit */ 


} 


[BRK RK KK KK RR RR RR RR A RR AR A RR A OR OR RR I I / 


/* C_INT99 - Interrupt service routine */ 
[BRK KK KK RR RR RR AR RR A ARR A RAR ARR A I I I I / 
#define dummyISR c_int99 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 


} 


for (;;); /* Replace with real ISR */ 


File: vecs.h 


[BORK RK KK RR RR RRR A A RR RR AR RR RRR OR OR OR I I / 


/* VECS.H - Header file for interrupt vector program ay 
[BRK KK KR RR RR RR RR RR RRR RRR RR A I I OR I I / 


#include <intpt40.h> 
#include <timer40.h> 
void c_int99 (void); 
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File: test.cmd 


[KKK IK IK I I I I I I I I I I I I I I I I I I HO / 


/* TEST.CMD - C40 linker command file * / 


[RK HK IK IK I I I I I I I I HO HO / 


=e 
test.obj 
initvecs.obj 
-mtest.map 
-otest.out 
-stack 0x400 
-heap 0x400 
-lprts40.lib 
-lrts40.lib 


/* SPECIFY THE SYSTEM MEMORY MAP */ 


MEMORY 

{ 
VECS: org = 0x000000 len = 0x40 
RAMO: org = Ox2FF800 len = 0x400 /* RAM BLOCK 0 */ 
RAM1: org = Ox2FFCOO len = 0x400 /* RAM BLOCK 1 */ 
LOCAL: org = 0x300000 len = 0x7D00000 /* LOCAL BUS */ 
GLOBAL: org = 0x8000000 len = 0x8000000 /* GLOBAL BUS */ 


} 
/* SPECIFY THE 


ECTIONS ALLOCATION INTO MEMORY */ 


n 


SECTIONS 
{ 


" vector” > RAMO 


-bss: > LOCAL, block 0x10000 
const > LOCAL 

text > LOCAL 

cinit > LOCAL 

stack > LOCAL 

-sysmem: > RAMI 
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TMS320C40 Example Without the PRTS 


The following TMS320C4x example uses linker-assigned variables to pass the vector base address to a 
C-callable assembly language module to initialize the interrupt-vector-table pointer. Other parameters are 
passed to the routine as well to initialize the other interrupt registers. Here, two assembly language named 
sections are used to individually place the reset and interrupt vectors at different locations through the linker 
command file. 


File: test.c 


[BRK KK KR KR RR RR RRR RRR RR RA RRR A I I I / 


/* TEST.C - Test program Hey, 
[BRK RK KK KR RR RR RR RR RR RR RR RR OR OR I / 


#include "“vecs.h” 


[BRK RK KK KR RR RR RR RRR RR RR RRR RR I I RK I / 


/* MAIN - Main routine ays 
[BRK KK KR RR RR A RRR RR RR RR RR I OR IK I / 


void main(void) 
{ 


initInts (&évecTable, 0x1); /* Initialize interrupt environment */ 


for(;;); /* Replace with real code */ 


File: initvecs.c 


[BRK KK KR RR RRR RRR RR A AA RRR A I I I / 


/* INITVECS.C - Interrupt vector routines *:/; 
[BRK RK KK KK KR RR RR RR RR RA RR RR RR I I RR I / 


[KR KK KK KK RR RR RR RR RA RR RAR RR RR OR I / 


/* C_INT99 - Interrupt service routine */ 
[BRK KK KR RR RR RR A RRR A RAR RR ARR I I OR I I / 
#define dummyISR c_int99 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 
For Gp 7)¥ /* Replace with real ISR */ 
} 
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File: init.asm 
KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK EK 


* INIT.ASM — C-callable ASM routine to initialize interrupts 
KEKE KKK KKK KKK KK KKK KKK KK KKK KKK KEK KKK KKK KKK KKK KKK KKK KK KKK KK KKK 


;function prototype void initInts(unsigned int **, unsigned int) 


.file “init.asm” 
-globl _initInts 
FP .set AR3 
_initInts: 
PUSH FP ;manage stack on entry 
EDT SP, FP 
LDI *—-FP(2),RO ;get address of vector table 
LDI *-FP(3),I11E ;load int enable register 
LDPE RO, IVTP ;store address of vector table in IVTP 
LDI Oh, IIF ;Cclear the IIF register 
OR 2000h, ST ;enable interrupts globally via GIE 
;bit in status register 
LDI *-FP(1),R1 ;manage stack on exit 
BD R1 
LDI *FP,FP 
NOP 
SUBI 2,SP 
B R1 ;branch occurs 
.end 


File: vecs.h 
[BRK KK KK KR RR RR RR A RR RRR AAR RR RR I I I I / 


/* VECS.H Header file for interrupt vector program a 
[BRK KK KK RR RR RR RR RR RRR A RR RR RR RR I / 
extern void initInts(unsigned int **, unsigned int); 

extern unsigned int *vecTable; 


File: vecs.asm 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK 


* VECS.ASM — Reset and interrupt vector table for the ’C40. This example * 
* assumes that the reset vector and interrupt vectors will reside in me 
* different locations a8 
KKK KKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKKK 

SEE be "vecs.asm” ;file name 

.def IVECS ; IVECS defined in this module 

.ref _c_int00, _c_int99 ;reference all interrupt 


;vectors declared elsewher 


KKKKKKKKK KKK KK 


* Reset vector 
KKKKKKKKKKKKKK 


.sect “reset” ;define named section for reset vector 
.word _c_ int00O ;reset vector 
KKKKKKKKKKKKKKKKKKK 


* Interrupt vectors 
KKEKKKKKKKKKKKKKKKKK 


.sect "vectors” ;define named section for interrupt vectors 
IVECS .space 1 ;one reserved location 

-word _c_int99 j;interrupt vector 1 

-word _c_int99 j;interrupt vector 2 
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File: test.cmd 


[KK HK IK IK I I I I I I I I I I I I I I I I I I I I HO / 


/* TEST.CMD - C40 linker command file * / 


[RK KK IK IK I I I 


=¢ 
init.obj 
initvecs.obj 
vecs.obj 
test.obj 
-mtest.map 
-otest.out 
-stack 0x400 
-heap 0x400 
-lrts40.lib 


_vecTable = IVECS; /* Set vecTable to point to vector table */ 


/* SPECIFY THE SYSTEM MEMORY MAP */ 


MEMORY 
{ 
VECS: org = 0x000000 len = 0x40 
RAMO: org = Ox2FF800 len = 0x400 /* RAM BLOCK 0 */ 
RAMI: org = 0x2FFC00 len = 0x400 /* RAM BLOCK 1 */ 
LOCAL: org = 0x300000 len = 0x7D00000 /* LOCAL BUS */ 
GLOBAL: org = 0x8000000 len = 0x8000000 /* GLOBAL BUS */ 
} 
/* SPECIFY THE SECTIONS ALLOCATION INTO MEMORY */ 
SECTIONS 
{ 
“reset” > VECS 
“vectors” > RAM1 
-bss: > LOCAL, block 0x10000 
sCexcs > LOCAL 
wei nati: > LOCAL 
-const: > LOCAL 
-stack: > RAMO 
-sysmem: > LOCAL 
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TMS320C50 Example 


The following TMS320C5x example uses linker-assigned variables to pass the vector base address and 
initial register values to aC routine. This routine loads the interrupt-vector-table pointer and other interrupt 
registers using pointers to memory-mapped registers. Here, two assembly language named sections are 
used to individually place the reset and interrupt vectors at different locations through the linker command 
file. 


File: test.c 
[BRK KK KR KR KR RR RR RRR RRR RR RR ARR RA I OR I I / 


/* TEST.C - Test program ca 
[KR KK KK KK RR RR RR RR RR RR RR RR RRR RR OR OR I I / 


#include "vecs.h” 


[BRK KK KK KR RR RR RR A RA RA RR RR RRR I I I I / 


/* MAIN - Main routine */ 
[BRK RK RK KK RR RR RR RR RR RAR A RR RR OR OR KI / 


void main(void) 


{ 
initInts (&évecTable, 0x3); /* Enable interrupts INTO and INT1 */ 


for(;;); /* Replace with real code */ 


File: initvecs.c 


[KR KK KK KK RRR A RR RAR RRR RRA RAR A I I I I / 


/* INITVECS.C - Interrupt vector routines * / 
[BRK RK KK KK RR RR RR RR RR RRR RR OR OR I / 


[BRK KK RR RR A RRR RR RA AA RAR RA I I I I / 


/* initInts() - Initialize processor interrupt registers * 
[BRK KK KK KR KR RR RR RR RR RR RR RR OR OR RR / 


void initInts(unsigned int **vecTable, unsigned int imrValue) 


{ 


unsigned int *imr = (unsigned int *) 0x04; /* IMR register */ 

unsigned int *ifr = (unsigned int *) 0x06; /* IFR register */ 

unsigned int *pmst = (unsigned int *) 0x07; /* PMST register */ 

*pmst |= (unsigned int) vecTable; 

eTEE = Oxffff; /* Clear IFR register */ 

*imr |= imrValue; /* Load IMR register */ 
asm(”\t CLRC\t INTM”); /* Clear interrupt mask bit */ 


} 


[BRK KK KR KR RR RR RR RR RA RR RRA RRR I I I I / 


/* C_INT3 - Interrupt service routine * / 
[BRK RK KK RK RK RR A RR RR RRA RRR RR RR OR RK / 
#define dummyISR c_int3 /* Rename ISR to correspond to TI */ 


/* naming conventions */ 
void dummyISR (void) 
{ 


} 


for(;7); /* Replace with real ISR */ 


File: vecs.h 
[BORK KK KK KR KR RRR RR RR RR RA RA RR RR RK / 


/* VECS.H - Header file for interrupt vector program xf 
[BRK KK KK RR RR RRA RRR AAR RRR A A I I I OR I / 


extern void initInts(unsigned int **, unsigned int); 
extern unsigned int *vecTable; 
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File: 


vecs.asm 


KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


* VECS.ASM 


— Reset and interrupt vector table for the ’C50 


* 


KKK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


-title "vecs.asm” 
.def IVECS 7 1V 
.cef _—c_int0,_c_int3 


;file name 


ECS defined in this module 
;reference all interrupt 


;vectors declared 


KKKKKKKKKKK KKK 


* Reset vector 
KKKKKKKKKKKKKK 


-sect “reset” 


,defin 


b _c_int0 


KKKKKKKKKKKKKK KK KKK 


* Interrupt vectors 
KKEKKKKKKKKKKKKKKKKK 


-sect “vectors” 


;defin 


;reset vector 


IVECS .space 2G 
b c_int3 
b i EES 


lsewher 


named section for reset vector 


named section for interrupt vectors 
;one reserved location 

;interrupt vector 1 
;interrupt vector 2 


File: 


[RK KK IK IK I I I I I I I I I I I I I I I I I I I I / 


/* TEST.CMD - C50 linker command file 


[RK IK IK IK I I I I I 


aE 
vecs.obj 
initvecs.obj 
test.obj 
-mtest.map 
-otest.out 
-stack 0x400 
-heap 0x400 
-lrts50.lib 


_vecTable = IVECS; /* Set vecTable 


MEMORY 
{ 
PAGE 0: VECTORS: origin 
ROM: origin 
P_RAM: origin 
EXT_PRGM origin 
PAGE 1: REGS: origin 
_O: origin 
RAMB2: origin 
RAMBO_D origin 
RAMB1: origin 
INT_RAM origin 
E DATA origin 
} 
SECTIONS 
{ 
"rveset” > VECTORS 
"vyectors” > P_RAM 
-text > ROM 
-cinit > ROM 
.bss > RAMBO_D 
.stack > INT_RAM 
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test.cmd 


to point to 


00000 
00030 
00800 
02c00 
00000 
00050 
00060 
00100 
00300 
00800 
02C00 


leng 
leng 
leng 
leng 
Leng 
leng 
leng 
leng 
leng 
leng 


leng 


vector table */ 


Ch ehch Ce etch Ce etch chet 


Spey Tey Tees 


0002fh 
OO7CFh 
O23FFh 
OD1IFFh 
00050h 
00010h 
00020h 
00200h 
00200h 
O23FFh 
OFFFFh 
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